<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
    <head>
        <title>CruiseControl.NET : Servers Configuration Block</title>
	    <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">	    
    </head>

    <body>
	    <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
		    <tr>
			    <td valign="top" class="pagebody">
				    <div class="pageheader">
					    <span class="pagetitle">
                            CruiseControl.NET : Servers Configuration Block
                                                    </span>
				    </div>
				    <div class="pagesubheading">
					    This page last changed on Nov 01, 2008 by <font color="#0050B2">williams</font>.
				    </div>

				    <p>The Dashboard needs to connect over the network to each of Build Servers you want to report on. If you have changed any of the <em>remoting</em> configuration for your servers, you'll need those details now. (See <a href="Server Application Config File.html" title="Server Application Config File">Server Application Config File</a> for more details on configuring remoting and management URLs.)</p>

<p>To configure the dashboard, add a <tt>&lt;server&gt;</tt> tag for each CruiseControl.NET Server you want to monitor to the <tt>&lt;servers&gt;</tt> section.</p>

<h3><a name="ServersConfigurationBlock-Example"></a>Example</h3>

<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"><span class="code-tag">&lt;servers&gt;</span>
    <span class="code-tag">&lt;server name=<span class="code-quote">"local"</span> url=<span class="code-quote">"tcp://localhost:21234/CruiseManager.rem"</span> allowForceBuild=<span class="code-quote">"true"</span> allowStartStopBuild=<span class="code-quote">"true"</span> /&gt;</span>
<span class="code-tag">&lt;/servers&gt;</span></pre>
</div></div>

<h3><a name="ServersConfigurationBlock-ConfigurationElements"></a>Configuration Elements</h3>

<p><tt>&lt;server&gt;</tt> tags have the following syntax:</p>
<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Node </th>
<th class='confluenceTh'> Description </th>
<th class='confluenceTh'> Type </th>
<th class='confluenceTh'> Required </th>
<th class='confluenceTh'> Default </th>
</tr>
<tr>
<td class='confluenceTd'> <a name="ServersConfigurationBlock-name"></a> name </td>
<td class='confluenceTd'> A referential name for the server - this must be unique for each server monitored by the Dashboard </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> n/a </td>
</tr>
<tr>
<td class='confluenceTd'> <a name="ServersConfigurationBlock-url"></a> url </td>
<td class='confluenceTd'> The management URL for the Server </td>
<td class='confluenceTd'> string </td>
<td class='confluenceTd'> yes </td>
<td class='confluenceTd'> n/a </td>
</tr>
<tr>
<td class='confluenceTd'> allowForceBuild </td>
<td class='confluenceTd'> Displays or hides the Force Build button on the Project Dashboard page </td>
<td class='confluenceTd'> bool </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> true </td>
</tr>
<tr>
<td class='confluenceTd'> allowStartStopBuild </td>
<td class='confluenceTd'> Displays or hides the Stop Build button on the Project Dashboard page.  Stopping a build will stop the project's triggers so that they will not trigger new builds until the project is started again; this will not abort a build that is in progress. </td>
<td class='confluenceTd'> bool </td>
<td class='confluenceTd'> no </td>
<td class='confluenceTd'> true </td>
</tr>
</tbody></table>

				    
                    			    </td>
		    </tr>
	    </table>
	    <table border="0" cellpadding="0" cellspacing="0" width="100%">
			<tr>
				<td height="12" background="http://confluence.public.thoughtworks.org//images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
			</tr>
		    <tr>
			    <td align="center"><font color="grey">Document generated by Confluence on Sep 29, 2009 20:59</font></td>
		    </tr>
	    </table>
    </body>
</html>